home *** CD-ROM | disk | FTP | other *** search
/ Aminet 25 / Aminet 25 (1998)(GTI - Schatztruhe)[!][Jun 1998].iso / Aminet / misc / emu / atari800_tr.lzh / INSTALL < prev    next >
Encoding:
Text File  |  1997-04-03  |  5.1 KB  |  131 lines
  1. Installation of the Atari 800 Emulator
  2. --------------------------------------
  3.  
  4. Irrespective of whether you are going to compile the emulator yourself
  5. or install a pre-compiled binary version you must obtain a copy of the
  6. Operating System ROMs.
  7.  
  8. The ROM images are distributed within the PC Xformer 2.5 package (other
  9. versions of this program do not contain the ROMs in a suitable format)
  10. which can be downloaded from:-
  11.  
  12. http://www.signus.demon.co.uk/david/atari/atari.html
  13.  
  14. If you are creating the ROM images yourself they should be copied from
  15. the following locations:-
  16.  
  17. 1. Atari Basic (8192 bytes between $a000 and $bfff)
  18. 2. Atari OS/A (10240 bytes between $d800 and $ffff)
  19. 3. Atari OS/B (10240 bytes between $d800 and $ffff)
  20. 4. Atari XL/XE (16384 bytes between $c000 and $ffff)
  21. 5. Atari 5200 (2048 bytes between $f800 and $ffff)
  22.  
  23. Note: If you are extracting the atarixl.rom you will find that the
  24.       ROM area under the custom chip ($d000 to $d7ff) are mapped
  25.       between $5000 and $57ff when bit 7 of PORTB is set to 1.
  26.  
  27.       i.e. You should set bit 7 of PORTB and then dump the memory
  28.            out in the following order:- $c000 to $cfff, $5000 to $57ff
  29.            and finally $d800 to $ffff.
  30.  
  31. The first time you run the emulator you will be prompted for the
  32. location of the ROMs and various other defaults. If you want to
  33. change any of these in the future simply start the emulator with
  34. the "-configure" command line option.
  35.  
  36. Compiling the Emulator
  37. ----------------------
  38.  
  39. The emulator can be compiled for the following systems (and probably
  40. many others with a little work):-
  41.  
  42. 1. X Window Version (Including SUN OpenWindows) on a Unix Platform
  43. 2. SVGALIB Version on Linux
  44. 3. CURSES version for UNIX
  45. 4. Graphical Version for the Amiga
  46. 5. BASIC version (No Graphics). Should be straightforward to configure
  47.    for any 32 bit environment supporting ANSI C.
  48. 6. VGA Version for DOS
  49.  
  50.    Note: I don't say 32 bit computer because certain operating systems
  51.    enforce a 16 bit memory model. No prizes are offered for correctly
  52.    identifing the OS in question.
  53.  
  54. Building the Emulator on a Unix Platform
  55. ----------------------------------------
  56.  
  57. 1. Type "make" for a list of supported platforms.
  58. 2. Select the most appropriate platform and type "make <platform>"
  59.    for instance if you want the linux svgalib version you would type
  60.    "make linux-svgalib"
  61. 3. Install the emulator by typing "make install". If you are building
  62.    one of the linux svgalib versions then you should login as root
  63.    and type "make install-svgalib" this is because svgalib programs
  64.    need to be run setuid root.
  65.  
  66. Building the Emulator for Curses
  67. --------------------------------
  68.  
  69. Follow the instruction for Unix but note that you must be using the
  70. System V Curses Library. BSD Curses is lacking a few functions and
  71. will not work (nodelay, attron, attroff, keypad and curs_set).
  72.  
  73. Building the Emulator for VAX/VMS
  74. ---------------------------------
  75.  
  76. This version only support the BASIC text only mode. You will be
  77. able to run programs such as:- DOS 2.5, DOS XL, MAC65 (disk version),
  78. Atari Basic and similar programs. I have had reports that you can
  79. make the X11 version run under DEC-Windows with a little work.
  80.  
  81. Note: I have not built this version for a while. Modifications may be
  82.       required to vmsbuild.
  83.  
  84. To build type @vmsbuild at the command line. I have compiled it with
  85. GNU C 2.6.1 but I don't expect problems with other versions. It
  86. will probably compile OK on VAX C but it will require the appropriate
  87. compilation options to be inserted into vmsbuild.com
  88.  
  89. atari800 :== $DISK$xxxx:[yyyy]atari800.exe
  90.  
  91.     where xxxx is the disk the software is on.
  92.           yyyy is the directory the software is in.
  93.  
  94. Building the Emulator for the CBM Amiga
  95. ---------------------------------------
  96.  
  97. Compiler: GNU C + DICE C (Lattice C Untried)
  98.  
  99. There is a separate makefile provided for the Amiga - Makefile.amiga
  100. By default it is setup for use with GCC. If you are using Dice C you
  101. will need to comment out the GCC section and remove the comments from
  102. the Dice section. Unfortunately I don't use DICE C very often so if
  103. it no longer compiles please let me know.
  104.  
  105. GNU C is available on AMINET under dev/gcc but needs about 6MB to
  106. compile the emulator.
  107.  
  108. For GCC be sure that the C_INCLUDE_PATH environment variable is
  109. pointing to the location of the official Commodore include files
  110. prior to compiling the emulator.
  111.  
  112. For example:
  113.     setenv C_INCLUDE_PATH /path/of/cbm/includes
  114.  
  115. Building the Emulator for DOS
  116. -----------------------------
  117.  
  118. To compile, use DJGPP the DOS port of gcc, which can be get from
  119. http://www.delorie.com/djgpp/. You don't need any contrib libraries.
  120. A basic setup will do. (I haven't tested the EZ-DJGPP distribution,
  121. but I suppose that's all you need).
  122.  
  123. If you have GCC, the second thing to do is rename Makefile to Makefile.org
  124. and Makefile.dos to Makefile. Now type "make vga", answer the questions
  125. required by "configure" and wait for gcc to build atari800.exe. To run
  126. this binary, you'll need to set the following environment variables:
  127.  
  128. Also, if you run it in DOS mode and you have not installed DJGPP, but you
  129. want to run the binary files, you'll need to install CWSDPMI by
  130. typing cwsdpmi -p. To unload cpsdmi, type cwsdpmi -u.
  131.